！ 本篇文章將會介紹 opencode TUI 的介面與基本操作，讓你不再只會打字送出，把每個角落都走一遍 :D

TL;DR: https://dev.benben.me/slides/s/ironman-03-tui-tour

本篇目標

讀完這篇你會學到：

• 看懂 TUI 畫面的三大區塊，知道每個角落在幹嘛
• 學會操作 opencode 的入門用法：/ 命令、@ 引用、Tab 切模式（再加一個彩蛋 !）
• 會建立、切換、整理 session，讓對話不再是一團亂

畫面地圖：你的駕駛艙

打開 opencode，畫面基本上分三塊：

• 訊息區：對話歷史，AI 改了什麼檔案、跑了什麼指令都會顯示在這
• 輸入區：打 prompt 的地方，你的主戰場
• 狀態列：畫面邊邊角角的資訊——目前在 Build 還是 Plan mode、用哪個 model，都看這裡

就像開車要先搞懂儀表板，認識這三塊之後，接下來的操作都會有畫面可以對照。

3 + 1 個入門用法：每天都會用到的操作

入門用法一：/ 命令選單

輸入 / 會跳出所有內建命令。先認識這幾個最常用的：

發現了嗎？大多數命令都有 ctrl+x 開頭的快捷鍵——ctrl+x 是所謂的 leader key，Day 08 會教你怎麼自訂。

筆者最愛的是 /editor：打落落長的 prompt 時，開 NeoVim 來寫比在輸入框改字舒服太多（記得 EDITOR 環境變數要設好，GUI 編輯器要加 --wait）。

入門用法二：@ 檔案引用

auth 是怎麼處理的？看 @src/api/index.ts

輸入 @ 會跳出 fuzzy search，選到的檔案內容會自動加進對話。不用複製貼上整個檔案，AI 直接讀原文。

入門用法三：模式切換

按 Tab 在 Build / Plan mode 之間切換（Day 05 會專門講怎麼搭配使用）。

彩蛋：! 直接跑 bash

!ls -la

訊息開頭打 ! 可以直接跑 shell 指令，輸出會自動加進對話——臨時想讓 AI 看個 git log 或測試輸出，超方便。

Session 管理：你的對話抽屜

一個 session 就是一個獨立的對話空間。筆者的習慣是一個任務開一個 session：修 bug 一個、code review 一個、問問題一個。好處是 context 不會互相污染，回頭找東西也快。

• 開新 session：/new（或 ctrl+x n）
• 回顧 / 切換歷史 session：/sessions（或 ctrl+x l）

小小測驗：你知道怎麼在對話中間塞一張圖片給 AI 看嗎？（答案在 Day 06 揭曉，先賣個關子）

順手玩一下個人化

• /themes（ctrl+x t）：即時預覽換主題，找到順眼的再說
• ctrl+p：命令面板（command palette），搜尋各種 TUI 設定，改了會自動記住
• /thinking：Toggle 開關，可以看到支援推理的 model 的思考過程——觀察 AI 怎麼想事情，比看結果更有趣

深入客製（keybinds、tui.json）就留給 Day 08，今天先記三寶就好。

常見問題 / 踩坑記錄

• Q：滑鼠可以滾動畫面嗎？
  A：可以，TUI 預設開啟 mouse 支援。如果跟 terminal 原生的選取行為打架，可以在 tui.json 把 mouse 關掉，還原原生捲動。
• Q：/undo 按了沒反應？
  A：/undo 底層靠 Git 管理檔案變更，專案必須是 Git repository 才行（Day 07 會細講）。
• Q：字體顯示方框亂碼？
  A：換個支援 Nerd Font 的字體，九成九是這個原因。

小結

• 畫面三區塊：訊息區、輸入區、狀態列
• 3 + 1 個入門用法：/ 命令、@ 引用、Tab 切模式、! 跑 bash
• session 是對話抽屜：一個任務一個抽屜，整齊不纏線

明日預告

Day 04：/init 與 AGENTS.md——讓 AI 真正認識你的專案，不再每次都從零開始猜。

參考資料：

• TUI | opencode docs
• Keybinds
• Themes

有任何疑問但沒有 iT 邦幫忙帳號，或是想匿名提問？
歡迎到 https://dev.benben.me/q/P3C5U6 提問或加油打氣，沒意外的話會在完賽之後一起回答 :D